home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3s / vfwprintf.z / vfwprintf
Encoding:
Text File  |  2002-10-03  |  7.1 KB  |  131 lines
  1.  
  2.  
  3.  
  4. vvvvffffwwwwpppprrrriiiinnnnttttffff((((3333SSSS))))                                                    vvvvffffwwwwpppprrrriiiinnnnttttffff((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _vvvv_ffff_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_:::: _vvvv_ffff_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_,,,, _vvvv_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_,,,, _vvvv_ssss_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff  - wide-character formatted
  10.      output of a stdarg argument list
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_dddd_iiii_oooo_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_wwww_cccc_hhhh_aaaa_rrrr_...._hhhh_>>>>
  15.      _iiii_nnnn_tttt _vvvv_ffff_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_FFFF_IIII_LLLL_EEEE _****_ssss_tttt_rrrr_eeee_aaaa_mmmm_,,,, _cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_ffff_oooo_rrrr_mmmm_aaaa_tttt_,,,, _...._...._...._))))_;;;;
  16.      _iiii_nnnn_tttt _vvvv_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_ffff_oooo_rrrr_mmmm_aaaa_tttt_,,,, _...._...._...._))))_;;;;
  17.      _iiii_nnnn_tttt _vvvv_ssss_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_ssss_,,,, _ssss_iiii_zzzz_eeee______tttt _nnnn_,,,, _cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_ffff_oooo_rrrr_mmmm_aaaa_tttt_,,,, _...._...._...._))))_;;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _vvvv_ffff_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff places output on the named output _s_t_r_e_a_m.
  21.  
  22.      _vvvv_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff places output on _ssss_tttt_dddd_oooo_uuuu_tttt.
  23.  
  24.      _vvvv_ssss_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff places output, followed by a null wide-character in consecutive
  25.      wide-characters starting at *_s; no more than _n wide-characters are
  26.      written, including a terminating null wide-character, which is always
  27.      added (unless n is zero).
  28.  
  29.      Each function returns the number of wide-characters transmitted (not
  30.      including the terminating null character in the case of _vvvv_ssss_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff), or a
  31.      negative value if an output error was encountered.  If n or more wide
  32.      characters were requested to be written _vvvv_ssss_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_)))) returns a negative
  33.      value.
  34.  
  35.      The _vvvv_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_)))), _vvvv_ffff_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_)))) and _vvvv_ssss_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_)))) functions are the same as
  36.      _wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_)))), _ffff_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_)))) and _ssss_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_)))) respectively, except that instead of
  37.      being called with a variable number of arguments, they are called with an
  38.      argument list as defined by <stdarg.h>.
  39.  
  40.      These functions do not invoke the va_end macro. However, as these
  41.      functions do invoke the va_arg macro, the value of ap after the return is
  42.      indeterminate.
  43.  
  44. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  45.      The following example shows the use of the vfwprintf function in a
  46.      general error reporting routine.
  47.  
  48.           #include <stdarg.h>
  49.           #include <stdio.h>
  50.           #include <wchar.h>
  51.  
  52.           void error(char *function_name, wchar_t *format, ...);
  53.           {
  54.                va_list args;
  55.                va_start(args, format);
  56.                /* print out name of function causing error */
  57.                fwprintf(stderr, L"ERROR in %s: ", function_name);
  58.                /* print out remainder of message */
  59.  
  60.  
  61.                                                                         PPPPaaaaggggeeee 1111
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. vvvvffffwwwwpppprrrriiiinnnnttttffff((((3333SSSS))))                                                    vvvvffffwwwwpppprrrriiiinnnnttttffff((((3333SSSS))))
  69.  
  70.  
  71.  
  72.                vfwprintf(stderr, format, args);
  73.                va_end(args);
  74.           }
  75.  
  76. NNNNOOOOTTTTEEEESSSS
  77.      These functions are supported in n32 and 64 bit C Libraries for IRIX
  78.      6.5.17 and later versions.
  79.  
  80. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.      _ffff_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff(3S), _ssss_tttt_dddd_aaaa_rrrr_gggg(5), _ssss_tttt_dddd_iiii_oooo(3S), _wwww_iiii_dddd_eeee_cccc(3S).
  82.  
  83. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  84.      _vvvv_ffff_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff, _vvvv_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff, and _vvvv_ssss_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff return the number of wide-characters
  85.      transmitted (not counting the terminating null character for _vvvv_ssss_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff),
  86.      or return a negative value if an error was encountered.  If _n or more
  87.      wide characters were requested to be written _vvvv_ssss_wwww_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_)))) returns a
  88.      negative value.
  89.  
  90.      In addition, all forms of vfwprintf() may fail if:
  91.  
  92.      [EILSEQ]
  93.           A wide-character code that does not correspond to a valid
  94.           character has been detected.
  95.      [EINVAL]
  96.           There are insufficient arguments.
  97.  
  98.      In addition, vwprintf() and vfwprintf() may fail if:
  99.  
  100.      [ENOMEM]
  101.           Insufficient storage space is available.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.